PCM_ Pen Collection Mode

Pen collection mode values define the condition that terminates an input session. (The system is said to be in  pen collection mode  during an input session when pen movement generates input data instead of being interpreted as mouse movement.) Pen collection can be stopped on any of the following conditions set by the PCM_ values in the dwPcm member of the PCMINFO1AOCX8 structure:

Constant

Description

PCM_ADDDEFAULTS

Combine the default termination conditions with those specified by the application.

PCM_DOPOLLING

Request polling mode, rather than the default WM_PENEVENT messages.

PCM_INVERT

Stop pen collection if the user touches the  eraser  end of the pen to the tablet. Not all tablets can detect this event.

PCM_PENUP

Stop pen collection when the pen is lifted from the tablet.

PCM_RANGE

Stop pen collection when the pen leaves tablet s range of sensitivity. Not all tablets can detect this event.

PCM_RECTBOUND

Stop when the pen is placed down outside the inclusion rectangle. The inclusion rectangle is specified in the rectBound member of the PCMINFO1AOCX8 structure.

PCM_RECTEXCLUDE

Stop when the pen touches inside the exclusion rectangle. The exclusion rectangle is specified in the rectExclude member of the PCMINFO1AOCX8 structure.

PCM_RGNBOUND

Stop when the pen touches outside the bounding region specified in the hrgnBound member of the PCMINFO1AOCX8 structure.

PCM_RGNEXCLUDE

Stop when the pen touches inside the exclusion region specified in the hrgnExclude member of the PCMINFO1AOCX8 structure.

PCM_TAPNHOLD

Enable detection of the tap-and-hold gesture.

PCM_TIMEOUT

Stop pen collection if there is no pen activity for a specified time-out. The time-out value is specified in the dwTimeout member of the PCMINFO1AOCX8 structure.